package com.numberone.iotplatform.dto;

import lombok.Data;

import javax.validation.constraints.Max;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;

/**
 * 数据传输对象 (DTO)，用于接收前端发起的设备扫描请求。
 * 包含了启动扫描所需的所有参数。
 */
@Data
public class ScanRequestDTO {

    /**
     * 要扫描的IP地址范围，格式如 "192.168.1.1-254"。
     * 使用 @NotBlank 确保存入的字符串不为空。
     */
    @NotBlank(message = "IP地址范围不能为空")
    private String ipRange;

    /**
     * 要扫描的设备端口。
     */
    @NotNull(message = "端口不能为空")
    @Min(value = 1, message = "端口号必须大于0")
    @Max(value = 65535, message = "端口号不能超过65535")
    private Integer port;

    /**
     * 用于尝试登录设备的通用用户名。
     */
    @NotBlank(message = "用户名不能为空")
    private String username;

    /**
     * 用于尝试登录设备的通用密码。
     */
    @NotBlank(message = "密码不能为空")
    private String password;
}